home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / bbs / wp_hb / wphb.doc < prev    next >
Text File  |  1993-06-05  |  7KB  |  139 lines
  1.                   WPHB 1.8 (C) 1993 Dean R. Madsen, KE0WO
  2.  
  3.              Brief notes on the WPHB.EXE program (Sorry, someday I will
  4.              learn to write comprehensive .DOC files).
  5.  
  6. What it does:   REQHB reads the white page update message texts (ie:MESS.WP).
  7.                 It looks for any question marks in the update lines for
  8.                 US and Canadian calls, if it finds any it then it accesses
  9.                 HamBase and fills in the question mark fields with the needed
  10.                 data from HamBase (if any).  WPHB will not replace data that
  11.                 already exists in the white pages with that from HamBase, it
  12.                 only replaces the ?'s if possible.
  13.  
  14. How it does it: REQHB will read through a specified file.  First it checks to
  15.                 see if a line that it has read is for a US or Canadian call.
  16.                 If it is, then the program check to make sure that there is
  17.                 data missing (name, zip, location) represented by question 
  18.                 marks.  Assuming the previous two tests pass, the program
  19.                 then compares the date of the WP update line with the date
  20.                 from the computer's clock.  If it is the same date the
  21.                 program writes that update line to the file \WPHB.DAT.  
  22.                 This file is a storage file for WP update lines to be
  23.                 processed at a later time.  It seems that the FBB white pages
  24.                 will not accept an update if it has been updated for the
  25.                 same callsign previously that day.  The \WPHB.DAT file will
  26.                 be checked before the program processes a specified file.
  27.                 
  28.                 If a call was seen on a previous date then the program will
  29.                 call the hambase program which will write the output for the
  30.                 callsign to the \wphb.in file.  The WPHB program will then
  31.                 read and delete the WPHB.IN file.  If hambase found the
  32.                 callsign then the missing data will be remade into a WP update
  33.                 message to your system in the \fbb\mail.in file.  The BBS will
  34.                 later import the message into the BBS for the white pages to
  35.                 process.  The subject of the message to WP from WP will be
  36.                 WP update from HAMBAS.
  37.  
  38. Set up/use:     To set the program up so that the program will send
  39.                 update messages automatically you will need to edit the
  40.                 APPEL.BAT file so that WPHB is run right after the EPURWP
  41.                 program during the system's housekeeping cycle.  The
  42.                 parameters you will need are: 
  43.                 1: the drive:\path\hambase lookup program.exe
  44.                 2: the drive:\path\file to process (optional)
  45.                 (WPHB processes \FBB\SYSTEM\WP\MESS.WP by defualt)
  46.  
  47.                 What it looks like on my system:
  48.                 
  49.                 :suite
  50.                 cls
  51.                 echo
  52.                 echo Backup of important files...
  53.                 copy \fbb\system\dirmes.sys \fbb\backup\dirmes.s1
  54.                 copy \fbb\system\inf.sys \fbb\backup\inf.s1
  55.                 echo Cleaning up message-files...
  56.                 del epurmess.res
  57.                 CD\FBB
  58.                 PICK585A
  59.                 epurmess
  60.                 cd\fbb
  61.                 report
  62.                 epurwp
  63.                 wphb d:\hambase\hambase.exe
  64.                 echo Press Control-C to abort!
  65.                 sleep 3
  66.                 
  67.  
  68.                 You will notice that Hambase is on my D: drive int he \hambase
  69.                 directory and the lookup program is hambase.exe.  Since I
  70.                 didn't change the default paths during FBB setup I allow WPHB
  71.                 to process the \FBB\SYSTEM\WP\MESS.WP, the default file that
  72.                 will become your outgoing WP update message to other systems.
  73.  
  74.                 While the program will not change you outgoing message.  It
  75.                 will add the missing data to your White Pages, which will 
  76.                 eventually send out an update that contains the new data.
  77.  
  78.  
  79.                 You may also use the M & MA commands to send all WP update
  80.                 messages you receive into a file to be processed by the WPHB
  81.                 programs.  If you have a multitasking program such as DesqView
  82.                 You may open another window and run the WPHB program having
  83.                 the second parameter being the path and name of the file to
  84.                 process.  If FBB is not shut down and is still running in
  85.                 another window, be sure to make the console channel busy
  86.                 (such as staying logged onto the BBS with the local console)
  87.                 so that the BBS doesn't attempt to import the MAIL.IN file
  88.                 before the WPHB program is finished.
  89.  
  90. Things you may
  91. want to know:   All updates made by Hambase will be of either /U or /I
  92.                 type.  It does change the /G type to /I when it fills in
  93.                 missing data and creates an update line.  This was orginally
  94.                 to help me debug the program, and I have not removed it.
  95.                 I suspected that the update message might not update the 
  96.                 local white pages with a /G update.
  97.  
  98.                 The program looks up each call individually and does add
  99.                 down time during housekeeping.  In the furture I may try to
  100.                 improve this a little.
  101.  
  102.                 I find it convieniant to put the WPHB.EXE program in the
  103.                 \FBB\BIN directory so that it is include in a directory
  104.                 in my PATH statement.
  105.  
  106. -----------------------------Conclusion-------------------------------------
  107.  
  108. 1. This software is freeware to the amateur community. It may not be sold.
  109.    It may be freely copied and distributed, but at no charge exceeding the
  110.    medium and shipping.
  111.  
  112. 2. No warranty is expressed or implied and incidental damages resulting from
  113.    the use of this software are solely the responsibility of the user. While
  114.    the software works fine, and I am willing to give it to the amateur 
  115.    community, I am not willing to assume any liabilty for it crashing your
  116.    computer or its peripherals. (It has not done that on any machine we have
  117.    run it on...this is just legal junk to prevent someone from holding me
  118.    responsible for being generous enough to give this utility away as a 
  119.    service to the FBB community.)
  120.  
  121. 3. Feedback on desired features, bugs, etc. is encouraged. 
  122.  
  123.  
  124. Good luck and 73,
  125. Dean - KE0WO
  126.  
  127. US Snail:  Dean R. Madsen, KE0WO
  128.            P. O. BOX 303
  129.            Storm Lake, IA  50588
  130.  
  131. Packet:    KE0WO @ KE0WO.#NWIA.IA.USA.NA
  132.  
  133. Internet:  MADSENDEAN@BVC.EDU
  134.  
  135. Land-line: (712) 732-2021  (Voice)
  136.            (712) 732-3767  (Data)  Latest servers in the \SERVERS direcotory
  137.                                    of my file section.
  138.  
  139.